home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / text / print / printmanager_1_1.lha / PrintManager_1.1 / PrintManager.doc < prev    next >
Text File  |  1993-02-09  |  6KB  |  167 lines

  1. ----------------------------------------------------------------------------
  2.  
  3.                               PrintManager 1.1
  4.  
  5. ----------------------------------------------------------------------------
  6.  
  7.  
  8. The files in this archive were written by Nicola Salmoria and are freely
  9. distributable as long as the archive remains intact, and only a nominal fee
  10. is charged for its distribution.
  11.  
  12. This software is provided "AS IS" without warranty of any kind, either
  13. expressed or implied. By using it, you agree to accept the entire risk as to
  14. the quality and performance of the program.
  15.  
  16. Comments, suggestions and bug reports are welcome.
  17.  
  18.    Nicola Salmoria
  19.    Via Piemonte 11
  20.    53100 Siena   ITALY
  21.  
  22.    At last I have an E-Mail address:
  23.  
  24.    MC6489@mclink.it
  25.  
  26.  
  27. Overview
  28. --------
  29. One of the things Workbench 2.0 (and 3.0) is still missing is a printer
  30. spooler.
  31. PrintManager is just that. There are some other programs that try to
  32. implement a spooler on the Amiga, but:
  33. · PrintManager is a system wedge, so it will work with every program, not
  34. just ones explicitly written to take advantage of it;
  35. · the wedge is installed at parallel or serial device level, so PrintManager
  36. will really work with EVERY program: no matter if it uses PRT: or directly
  37. the printer device, no matter if it's printing text or graphics.
  38. However, PrintManager will NOT work with programs which use PAR:, SER:, or
  39. the corresponding parallel and serial device: note that such behaviour is
  40. AGAINST Commodore guidelines, so I won't support it. See next point for a
  41. good reason...
  42. · only printer device calls are cached, so modem and net users will not
  43. experiment performance loss.
  44. · PrintManager features a graphic interface which you can use to rearrange
  45. jobs or pause the printing.
  46. · After a system crash or reset, you can recover unfinished printings. This
  47. feature may be used to prepare raw data and print it at a later time.
  48.  
  49.  
  50. Requirements
  51. ------------
  52. · OS 2.04 or later
  53. · Hard disk is not required but strongly recommended
  54. · Printer ;-)
  55.  
  56.  
  57. Installation
  58. ------------
  59. Copy spool.device in DEVS:.
  60. The spooler is actually activated by running PrintManager. Some parameters
  61. may be changed using the ToolTypes. Recognized ToolTypes are:
  62.  
  63. CX_POPUP                 default: YES
  64. CX_POPKEY                default: control alt p
  65. CX_PRIORITY              default: 0
  66. SPOOLDIR                 default: T:
  67. PAUSED                   default: NO
  68. APPICON                  default: ACTIVE
  69. ICONX
  70. ICONY
  71.  
  72. The first three are the usual Commodity ToolTypes, the other ones mean:
  73.  
  74. SPOOLDIR: the directory where temporary files should be stored. The default
  75.   is T:, which is usually assigned to RAM:T, but you should change it to
  76.   somewhere in your hard disk. Temporary files may be quite large, and you
  77.   could run out of memory very quickly.
  78.  
  79. PAUSED: this specifies if the printing should be paused upon startup. If you
  80.   set PAUSED=YES, nothing will be sent to the printer until you invoke the
  81.   GUI and start it.
  82.  
  83. APPICON: PrintManager can put an icon on the Workbench screen. Currently,
  84.   it may be used only to open the program window with a double-click; in a
  85.   future release, some action may be performed on icons dropped over it.
  86.  
  87.   There are three valid keywords for this ToolType:
  88.   ALWAYS - Show the icon when the program is started, remove it when
  89.     quitting.
  90.   NEVER - Never show the icon.
  91.   ACTIVE - Show the icon only if the job list is not empty and the window
  92.     is not open. This feature will help to remember if there are recovered
  93.     jobs after a reset.
  94.  
  95. ICONX and ICONY: These two specify the position where to put the icon.
  96.   If you don't specify both of them, Workbench will place it by itself.
  97.  
  98.  
  99. You will probably want to drag PrintManager in WBStartup, so don't forget
  100. to set CX_POPUP=NO.
  101.  
  102.  
  103. Using the GUI
  104. -------------
  105. GUI usage should be fairly intuitive; clicking on a job you get some info
  106. about it (creation date & time, size of temporary file, percentage printed,
  107. and so on). You may pause/restart the job using the Active/Paused cycle
  108. button, or remove it from the list with the Remove button. You can change
  109. the list order using the Up and Down buttons. A job being printed cannot be
  110. moved from the top of the list.
  111.  
  112. There is a special entry in the list, named "« Next Job »". It represents
  113. the position where the next job you start will be placed. The new job will
  114. also inherit the setting of the Active/Paused button. This means that if you
  115. set it to Paused, nothing will be printed until you explicitly start it.
  116. The initial setting of the Active/Paused button may be changed using the
  117. PAUSED ToolType.
  118.  
  119. When started, PrintManager will look in the SPOOLDIR you specified and see
  120. if there are jobs remained from previous session. If it finds some, they
  121. will be automatically inserted AFTER « Next Job », the first one will be
  122. paused. This way, you can continue to use the printer without taking care
  123. of old jobs; when you want to restart them, you just have to open the GUI
  124. and unpause the first one. Also remember to bring « Next Job » to the
  125. bottom of the list.
  126.  
  127.  
  128. Limitations
  129. -----------
  130. Currently, only one device at a time may be spooled. If for example you
  131. switch from parallel to serial, nothing sent to the serial port will be
  132. buffered until the spooler has finished with the parallel port.
  133.  
  134.  
  135. Future Enhancements
  136. -------------------
  137. Things which I may add to future revisions if I get enough request for them
  138. are:
  139. · AREXX port to allow asyncronous printing using some utility like 'cron'.
  140. · Handling of more than one device at a time (see 'Limitations').
  141. · Localization
  142. · Better documentation
  143. · Anything you suggest.
  144.  
  145.  
  146. Acknowledgments
  147. ---------------
  148. As usual, I have to thank my beta testers, whose help has been invaluable
  149. during the development of this program:
  150.  
  151. Stefano Iacus
  152. Federico Giannici
  153. Dante Profeta
  154. Marco Ciuchini
  155. Massimiliano Filacchioni
  156. Marcello Bianchetti
  157. Stefano Chiappini
  158.  
  159. Special thanks go to all the people which E-Mailed me useful suggestions and
  160. bug reports. In particular:
  161.  
  162. Matt Brookes
  163. Jeremy Friesner
  164. Bill Hogsett
  165.  
  166. Thank you very much!
  167.